| Server IP : 121.121.20.254 / Your IP : 216.73.216.202 Web Server : Microsoft-IIS/10.0 System : Windows NT WEB-SERVER 10.0 build 20348 (Windows Server 2022) AMD64 User : IUSR ( 0) PHP Version : 8.3.28 Disable Function : NONE MySQL : ON | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/Program Files/LibreOffice/help/en-US/text/sbasic/shared/ |
Upload File : |
<!DOCTYPE html>
<html lang="en-US" dir="ltr">
<head>
<base href="../../../../">
<noscript><meta http-equiv="refresh" content="0; URL=../../../../en-US/noscript.html"></noscript>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Organizing Libraries and Modules</title>
<link rel="shortcut icon" href="media/navigation/favicon.ico">
<link type="text/css" href="normalize.css" rel="Stylesheet">
<link type="text/css" href="prism.css" rel="Stylesheet">
<link type="text/css" href="default.css" rel="Stylesheet">
<script type="text/javascript" src="polyfills.js"></script><script type="text/javascript" src="languages.js"></script><script type="text/javascript" src="en-US/langnames.js"></script><script type="text/javascript" src="flexsearch.debug.js"></script><script type="text/javascript" src="prism.js"></script><script type="text/javascript" src="help2.js" defer></script><script type="text/javascript" src="a11y-toggle.js" defer></script><script type="text/javascript" src="paginathing.js" defer></script><script type="text/javascript" src="en-US/bookmarks.js" defer></script><script type="text/javascript" src="en-US/contents.js" defer></script><script type="text/javascript" src="help.js" defer></script><meta name="viewport" content="width=device-width,initial-scale=1">
</head>
<body>
<header id="TopLeftHeader"><a class="symbol" href="en-US/text/shared/05/new_help.html"><div></div></a><a class="logo" href="en-US/text/shared/05/new_help.html"><p dir="auto">LibreOffice 24.2 Help</p></a><div class="dropdowns"><div class="modules">
<button type="button" data-a11y-toggle="modules-nav" id="modules" aria-haspopup="true" aria-expanded="false" aria-controls="modules-nav">Module</button><nav id="modules-nav" hidden=""></nav>
</div></div></header><aside class="leftside"><input id="accordion-1" name="accordion-menu" type="checkbox"><label for="accordion-1" dir="auto">Contents</label><div id="Contents" class="contents-treeview"></div></aside><div id="SearchFrame"><div id="Bookmarks">
<input id="search-bar" type="search" class="search" placeholder="Search in bookmarks for chosen module" dir="auto"><div class="nav-container" tabindex="0"><nav class="index" dir="auto"></nav></div>
</div></div>
<div id="DisplayArea" itemprop="softwareHelp" itemscope="true" itemtype="http://schema.org/SoftwareApplication">
<a name="libs_modules"></a>
<a name="bm_id3148797"></a>
<meta itemprop="keywords" content="libraries,organizing">
<meta itemprop="keywords" content="libraries,containers">
<meta itemprop="keywords" content="modules,organizing">
<meta itemprop="keywords" content="copying,modules">
<meta itemprop="keywords" content="adding libraries">
<meta itemprop="keywords" content="deleting,libraries/modules/dialogs">
<meta itemprop="keywords" content="dialogs,organizing">
<meta itemprop="keywords" content="moving,modules">
<meta itemprop="keywords" content="organizing,modules/libraries/dialogs">
<meta itemprop="keywords" content="renaming modules and dialogs">
<h1 id="hd_id3148797" dir="auto">
<a name="01030400"></a>Organizing Libraries and Modules
</h1>
<h2 id="hd_id371574080559061" dir="auto">Basic Libraries Containers</h2>
<p id="par_id961574080563824" class="paragraph" dir="auto">LibreOffice Basic libraries can be stored in 3 different containers:</p>
<ul itemprop="Unordered" itemscope="true" itemtype="http://schema.org/ItemList" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_id571574079618609" class="listitem" dir="auto"><span class="emph">Application Macros</span>: libraries stored in this container are available for all users of the computer and are managed by the computer administrator. The container is located in the LibreOffice installation directory.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_id151574079741214" class="listitem" dir="auto"><span class="emph">My Macros</span>: libraries stored in this container are available to all documents of your user. The container is located in the user profile area and is not accessible by another user.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_id581574080384335" class="listitem" dir="auto"><span class="emph">Document</span>: libraries stored in the document container are only available for the document and are accessible only when the document is open. You cannot access macros of a document from another document.</p>
</li>
</ul>
<p id="par_id881574081445896" class="paragraph" dir="auto">To access macros stored in libraries of <span class="emph">Application Macros</span> or <span class="emph">My Macros</span> from another container, including the document container, use the <a target="_top" href="en-US/text/sbasic/shared/03131900.html">GlobalScope specifier</a>.</p>
<h2 id="hd_id3150868" dir="auto">Organizing Libraries</h2>
<h3 id="hd_id3125864" dir="auto">Creating a New Library</h3>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3152576" class="listitem" dir="auto">Choose <span class="emph">Tools - Macros - Organize Macros - Basic</span> and click <span class="emph">Organizer</span> or click the <span class="emph">Select Module</span> icon in the Basic IDE to open the <span class="emph">Macro Organizer</span> dialog.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3153726" class="listitem" dir="auto">Click the <span class="emph">Libraries</span> tab.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3149664" class="listitem" dir="auto">Select to where you want to attach the library in the <span class="emph">Location</span> list. If you select Application Macros & Dialogs, the library will belong to the LibreOffice application and will be available for all documents. If you select a document the library will be attached to this document and only available from there.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3153365" class="listitem" dir="auto">Click <span class="emph">New</span> and insert a name to create a new library.</p>
</li>
</ol>
<h3 id="hd_id3147394" dir="auto">Import a Library</h3>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3153157" class="listitem" dir="auto">Choose <span class="emph">Tools - Macros - Organize Macros - Basic</span> and click <span class="emph">Organizer</span> or click the <span class="emph">Select Module</span> icon in the Basic IDE to open the <span class="emph">Macro Organizer</span> dialog.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3146972" class="listitem" dir="auto">Click the <span class="emph">Libraries</span> tab.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3145640" class="listitem" dir="auto">Select to where you want to import the library in the <span class="emph">Location</span> list. If you select Application Macros & Dialogs, the library will belong to the LibreOffice application and will be available for all documents. If you select a document the library will be imported to this document and only available from there.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3154253" class="listitem" dir="auto">Click <span class="emph">Import...</span> and select an external library to import.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3154705" class="listitem" dir="auto">Select all libraries to be imported in the <span class="emph">Import Libraries</span> dialog. The dialog displays all libraries that are contained in the selected file.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3163807" class="listitem" dir="auto">If you want to insert the library as a reference only check the <span class="emph">Insert as reference (read-only)</span> box. Read-only libraries are fully functional but cannot be modified in the Basic IDE.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3145228" class="listitem" dir="auto">Check the <span class="emph">Replace existing libraries</span> box if you want existing libraries of the same name to be overwritten.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3147004" class="listitem" dir="auto">Click <span class="emph">OK</span> to import the library.</p>
</li>
</ol>
<h3 id="hd_id3159099" dir="auto">Export a Library</h3>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3147005" class="listitem" dir="auto">Choose <span class="emph">Tools - Macros - Organize Macros - Basic</span> and click <span class="emph">Organizer</span> or click the <span class="emph">Select Module</span> icon in the Basic IDE to open the <span class="emph">Macro Organizer</span> dialog.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3147006" class="listitem" dir="auto">Click the <span class="emph">Libraries</span> tab.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3147007" class="listitem" dir="auto">In the <span class="emph">Location</span> list you specify where your library is stored. Select the library that you want to export. Note that you cannot export the <span class="emph">Standard</span> library.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3147008" class="listitem" dir="auto">Click <span class="emph">Export...</span></p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3147009" class="listitem" dir="auto">Choose whether you want to export the library as an extension or as a BASIC library.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3147010" class="listitem" dir="auto">Click <span class="emph">OK</span>.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3147011" class="listitem" dir="auto">Select where you want your library exported.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3147012" class="listitem" dir="auto">Click <span class="emph">Save</span> to export the library.</p>
</li>
</ol>
<h3 id="hd_id3159100" dir="auto">Deleting a Library</h3>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3150086" class="listitem" dir="auto">Choose <span class="emph">Tools - Macros - Organize Macros - Basic</span> and click <span class="emph">Organizer</span> or click the <span class="emph">Select Module</span> icon in the Basic IDE to open the <span class="emph">Macro Organizer</span> dialog.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3146808" class="listitem" dir="auto">Click the <span class="emph">Libraries</span> tab.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3158212" class="listitem" dir="auto">Select the library to be deleted from the list.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3150361" class="listitem" dir="auto">Click <span class="emph">Delete</span>.</p>
</li>
</ol>
<ul itemprop="Unordered" itemscope="true" itemtype="http://schema.org/ItemList" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_id3152986" class="listitem" dir="auto">Deleting a library permanently deletes all existing modules and corresponding procedures and functions.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_id3148868" class="listitem" dir="auto">You cannot delete the default library named "Standard".</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_id3146869" class="listitem" dir="auto">If you delete a library that was inserted as reference only the reference is deleted but not the library itself.</p>
</li>
</ul>
<h2 id="hd_id3147070" dir="auto">Organizing Modules and Dialogs</h2>
<h3 id="hd_id3155265" dir="auto">Creating a New Module or Dialog</h3>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3154537" class="listitem" dir="auto">Choose <span class="emph">Tools - Macros - Organize Macros - Basic</span> and click <span class="emph">Organizer</span> or click the <span class="emph">Select Module</span> icon in the Basic IDE to open the <span class="emph">Macro Organizer</span> dialog.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3146781" class="listitem" dir="auto">Click the <span class="emph">Modules</span> tab or the <span class="emph">Dialogs</span> tab.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3159206" class="listitem" dir="auto">Select the library where the module will be inserted and click <span class="emph">New</span>.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3152389" class="listitem" dir="auto">Enter a name for the module or the dialog and click <span class="emph">OK</span>.</p>
</li>
</ol>
<h3 id="hd_id3152872" dir="auto">Renaming a Module or Dialog</h3>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3159230" class="listitem" dir="auto">Choose <span class="emph">Tools - Macros - Organize Macros - Basic</span> and click <span class="emph">Organizer</span> or click the <span class="emph">Select Module</span> icon in the Basic IDE to open the <span class="emph">Macro Organizer</span> dialog.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3150046" class="listitem" dir="auto">Click the module to be renamed twice, with a pause between the clicks. Enter the new name.</p>
<p id="par_id3153801" class="listitem" dir="auto">In the Basic IDE, right-click the name of the module or dialog in the tabs at the bottom of the screen, choose <span class="emph">Rename</span> and type in the new name.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3155526" class="listitem" dir="auto">Press Enter to confirm your changes.</p>
</li>
</ol>
<h3 id="hd_id3146963" dir="auto">Deleting a Module or Dialog</h3>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3147547" class="listitem" dir="auto">Choose <span class="emph">Tools - Macros - Organize Macros - Basic</span> and click <span class="emph">Organizer</span> or click the <span class="emph">Select Module</span> icon in the Basic IDE to open the <span class="emph">Macro Organizer</span> dialog.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3150958" class="listitem" dir="auto">Click the <span class="emph">Modules</span> tab or the <span class="emph">Dialogs</span> tab.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3149870" class="listitem" dir="auto">Select the module or dialog to be deleted from the list. Double-click an entry to reveal sub-entries, if required.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3147248" class="listitem" dir="auto">Click <span class="emph">Delete</span>.</p>
</li>
</ol>
<div class="warning">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/warning.svg" alt="warning" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id3151339" dir="auto">Deleting a module permanently deletes all existing procedures and functions in that module.</p></div>
</div>
<br>
<h2 id="hd_id3151392" dir="auto">Organizing Projects among Documents or Templates</h2>
<h3 id="hd_id3156400" dir="auto">Moving or copying modules between documents, templates and the application.</h3>
<ol itemprop="HowTo" itemscope="true" itemtype="http://schema.org/HowToSection" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3146819" class="listitem" dir="auto">Open all documents or templates among which you want to move or copy the modules or dialogs.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3149319" class="listitem" dir="auto">Choose <span class="emph">Tools - Macros - Organize Macros - Basic</span> and click <span class="emph">Organizer</span> or click the <span class="emph">Select Module</span> icon in the Basic IDE to open the <span class="emph">Macro Organizer</span> dialog.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/HowToStep" dir="auto">
<p id="par_id3145637" class="listitem" dir="auto">To move a module or dialog to another document, click the corresponding object in the list and drag it to the desired position. A horizontal line indicates the target position of the current object while dragging. Hold the <span id="swlnsystextsbasicshared01030400xml_1" class="switchinline"><span hidden="true" id="MACtextsbasicshared01030400xml_1" class="MAC">Command</span><span hidden="true" id="defaulttextsbasicshared01030400xml_1">Ctrl</span></span> key while dragging to copy the object instead of moving it.</p>
</li>
</ol>
</div>
<div id="DonationFrame"></div>
<footer><div id="DEBUG" class="debug">
<h3 class="bug">Help content debug info:</h3>
<p dir="auto">This page is: <a href="https://opengrok.libreoffice.org/xref/help/source/text/sbasic/shared/01030400.xhp" target="_blank">/text/sbasic/shared/01030400.xhp</a></p>
<p dir="auto">Title is: Organizing Libraries and Modules</p>
<p id="bm_module" dir="auto"></p>
<p id="bm_system" dir="auto"></p>
<p id="bm_HID" dir="auto"></p>
</div></footer>
</body>
</html>